home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 5 / The 640 Meg Shareware Studio CD-ROM Volume V (Data Express)(1994).ISO / amiga / hermit.lha / HERMiT / HERMiT.doc < prev    next >
Text File  |  1994-02-28  |  14KB  |  264 lines
  1.  
  2.                           HERMES' HERMiT (Version 1.4)
  3.  
  4.                      Copyright (c) 1988-94 A. G. Kartsatos
  5.                                  
  6.                               **** Shareware ****
  7.  
  8.     *** If you use this program by HERMES, please send US$15.00 to: ***
  9.  
  10.                                A. G. Kartsatos
  11.                           8524 Caladesi Island Drive
  12.                          Temple Terrace, FL 33637-7310
  13.  
  14.                      Compatible with ROMS 2.0, Amiga 3000)
  15.  
  16.         ((Saves/Cycles The Front Screen, Saves The Front Screen's Font,
  17.                Saves And Provides Code For The Front Window's
  18.                     As Well As The Preferences' Pointer,
  19.                      Opens A CLI On The Front Screen))
  20.  
  21.     Here is a new version of HERMiT.  This time HERMiT will also open a CLI
  22. on top of your Front Screen and will save your Front Window's Pointer in a
  23. system-configuration file.  It will also provide C code for the Front
  24. Window's as well as the Preferences' Pointer.  The old features are of course
  25. course still here: Saving of Front Screens, Cycling of Front Screens and 
  26. Saving of the Fonts of Front Screens.
  27.     The user should read this manual in its entirety in order to avoid
  28. unnecessary complications and frustration.  For example, you can read below
  29. how you may save the front screen although the usual key combination does
  30. not work because another running program is using it.
  31.  
  32.     ***It works from the Workbench or the CLI.  To run it from the CLI, just
  33. press RUN HERMiT.  Just click into its icon when you you want it to run from
  34. your Workbench.***
  35.  
  36.     You may run HERMiT now either from your startup-sequence or from your
  37. Workbench without having to enter anything in the HERMiT main panel.  Here
  38. is how you do it.
  39.  
  40.     1) STARTUP-SEQUENCE:  Just enter a line with "Run HERMiT -s <Drive/Dir>".
  41.        For example, the command "Run HERMiT -s RAM:Files" will save all
  42.        HERMiT fonts, pointers and screens in the directory RAM:Files.
  43.  
  44.     2) WORKBENCH:  Just enter in the HERMiT icon TOOLTYPES (get them with
  45.        the "Info" (or "Information") item of the WorkBench menu), the phrase:
  46.        HERMiT=RAM:Files.  HERMit will read this when it gets activated (by
  47.        clicking into its icon) and will save everything again into the
  48.        directory RAM:Files.  The icon is distributed with the TOOLTYPES
  49.        entry: HERMiT=VD0:  If you want to check whether HERMiT is actually
  50.        running in the background, just press: CTRL-LALT-H, as usual.
  51.  
  52.     If, in either case, HERMiT does not locate that drive/directory path, it
  53. will prompt you for such a path with its main panel.
  54.  
  55.     LALT denotes the Left ALT KEY on your keyboard.
  56.     To start HERMiT operating, you must enter a volume/directory where you
  57. want your pictures and fonts saved.  No actual filenames are needed and they
  58. will not work.  For example, assume that you want your pictures saved in
  59. the directory DF0:Pictures.  To guarantee this, just enter DF0:Pictures in 
  60. the gadget of the HERMiT screen and PRESS <RETURN>.
  61.  
  62.      In what follows, "Flash" means "sun the screen."
  63.  
  64.      COMMANDS:
  65.  
  66.     (I)  CTRL+LALT+S:  Saves The Front Screen. (Flashes before and after)
  67.  
  68.     This is a very useful feature when you need a copy of a screen of
  69. a word processor, a game, a utility, etc.  It saves OVERSCAN front screens
  70. too. The files are saved sequentially like GRABBiT to a directory/volume path
  71. that you specify when the HERMiT requester asks you for it.  The saving 
  72. format: HR_3MED.000 = HERMiT, 3 Planes, Medium Resolution, File Number 0.
  73. Another example: HR_6LACE.007 = HERMiT, 6 Planes, INTERLACE Mode, 8th File
  74. Saved.  Whenever HERMiT is run, the numbering of the pictures starts from
  75. 000.  This means that the user should make sure that he/she does not
  76. overwrite older pictures with the same number, resolution and planes as
  77. the new ones.
  78.  
  79.    (II)  CTRL+LALT+1, CTRL+LALT+2, CTRL+LALT+3:  Cycles Pictures At 3 Diffe-
  80.                                                  Speeds.
  81.          TAB KEY:  Stops The Cycling.
  82.  
  83.     HERMiT will cycle IFF pictures which with 8 to 32 colors (2-5 planes).
  84.     It will cycle the colors of the front screen at three different speeds
  85. corresponding to the above 3 key combinations.  The only uncycled color is
  86. the color in register 0.  It is usually the color outside the picture frame
  87. and it does not look good when you include it in the cycling.
  88.     Press the TAB KEY to stop the cycling.
  89.  
  90.   
  91.   (III)  CTRL+LALT+F:  Will Save The Front Screen's Font. 
  92.                        (Flashes Before And After)
  93.  
  94.     Well, all these Front-Screen saving operations are of course possible
  95. only when the running program allows you to do them.  When the running prog-
  96. ram uses the "Disable(), Forbid()" combinations (e.g., in the C Language),
  97. you cannot save the FrontScreen.
  98.  
  99.     To SAVE THE FONT, just PRESS: CTRL+LALT+F.  The program will check first
  100. to see if the font is just the TOPAZ one.  If it is, the program will notify
  101. you accordingly, and it will not save the font.  Let us assume that the font
  102. has the name HELLO and has size 11.  The program will try to see if a 
  103. directory exists in the assigned HERMiT path (above) with the name fonts.
  104. If it exists, HERMiT will try to save the font in there.  It will put a file
  105. called HELLO.font in that fonts directory, it will then open a directory
  106. in there with the name HELLO, and, finally, it will place into the HELLO
  107. directory a file with the name "11".
  108.  
  109.      If the fonts directory cannot be found in the assigned HERMiT path,
  110. HERMiT will create it and continue as above.
  111.  
  112.      The program WILL NOT CREATE A FONT IF THE FONT NAME ALREADY EXISTS IN
  113. THE HERMiT PATH/FONTS DIRECTORY.  This means that if there is a HELLO font
  114. already in that fonts directory, HERMiT will not create a font with the
  115. name HELLO even if the new font has a different size.
  116.  
  117.      If you do want to get that font anyway, just change the names of the
  118. three files of the HELLO font that are already there (HELLO.font, HELLO
  119. and 11), or delete them.
  120.  
  121.      Now, I do not really want to play with your current "fonts" directory.
  122. So, when you enter a path into the HERMiT gadget, please avoid entering
  123. a volume/directory that contains your valuable "fonts" directory.  This of
  124. course applies only when you are planning to save the screen font.
  125.  
  126.    (IV)  CTRL+LALT+P:  Saves The Front Window's Pointer.
  127.                        (Flashes Before And After)
  128.  
  129.      This of course means that THERE IS a pointer attached to your front
  130. window.  If there is no such pointer, HERMiT will notify you accordingly.
  131.      Also, HERMiT will not save your pointer if it is too large.  This means
  132. that if your pointer has width and/or height bigger than 16, HERMiT will tell
  133. you that your pointer is too large and will refrain fromm trying to save it.
  134.      *However, HERMiT will give you the C code for such an oversized pointer
  135. that you can use in your programs.*
  136.      HERMiT saves the pointer in a copy of your "system-configuration" file.
  137. This file resides in your "devs" directory and contains the entire current
  138. Preferences data of your machine.  HERMiT's copy is in the directory/drive
  139. thar has been initially specified by you and is named "HR_CONF".  REMEMBER:
  140. "HR_CONF" is a BINARY file.  In order to see the pointer this way, you just
  141. use the enclosed program "ShowPointer".  Just press "ShowPointer HR_CONF" and
  142. the program will set your pointer to the one in "HR_CONF".  This "ShowPointer"
  143. program will work with any system-configuration files that contain pointers
  144. of legitimate dimensions as above.  If you want the shown pointer to perma-
  145. nently become your pointer, just run the Preferences file and then save it.
  146. That's it!
  147.      Besides the image of the pointer, HERMiT will also save the colors of it.
  148. These are in color registers 17,18, and 19.
  149.  
  150.     (V)  CTRL+LALT+D:  Provides C Code For The Front Window's Pointer
  151.                        As Well As The Preferences' Pointer.
  152.                        (Flashes Before And After)
  153.  
  154.      This feature allows you to obtain the C code for the pointer if you want
  155. to use it in your own programs.  If the front window has no pointer attached
  156. to it, HERMiT will give you the C code for the pointer obtained from your
  157. Preferences (and not from your "devs:system-configuration" file).
  158.      If the front window has a pointer attached to it, HERMiT will give you
  159. the C code for that pointer.  In either case, the file containing the C code
  160. resides in your pre-specified directory/drive and has the name: "HR_PTRCODE".
  161.      *HERMiT will give you the C code also for oversized pointers that you
  162. can use in your programs.*
  163.  
  164.    (VI) CTRL+LALT+C:  Opens A New CLI On Top Of The Front Screen.
  165.     
  166.     HERMiT will open a new CLI on top of the front screen.  Naturally, this
  167. CLI will have the resolution of the top screen.  Please DO NOT MOVE THE TOP
  168. SCREEN OR THIS CLI TO THE BACKGROUND because you MIGHT LOSE THE CLI and the
  169. ability to further use HERMiT.  This can happen in resolutions other than
  170. HIRES (640x200).  So, use the CLI as you please (entering commands into it),
  171. and PRESS: ENDCLI to get rid of it when you are done.  Obviously, the file
  172. EndCLI should be in your c directory.  EndCLI is the only way to get rid
  173. of this new CLI.  HERMiT will not open a new CLI whenever your screen's
  174. width is smaller than 250.  If you do not get a new CLI this way, it means
  175. that HERMiT cannot open the window in the present environment.
  176.    HERMiT checks to see if you have the NewCLI command in your c directory.
  177.    If you do, HERMiT runs that command and gives you a NewCLI with the reso-
  178. lution of your front screen.  If you do not, HERMiT will open its own CLI
  179. on your front screen.  Both types of CLI will be "smart" when HERMiT is run-
  180. ning from the CLI.  However, when HERMiT is running for the Workbench,
  181. either type of CLI will not be as smart.  They will recognize all the commands
  182. in your assigned c directory, but not the commands from the path.  Naturally,
  183. in such a case you may still run a path command inside the CLI to establish
  184. the path that you desire.
  185.  
  186.   (VII)  CTRL+LALT+H:  Checks Whether HERMiT Has Been Activated. (Flash)
  187.  
  188.  (VIII)  CTRL+LALT+Q:  Stops HERMiT From Running In The Background. (Flash)
  189.                        Same effect by pressing: "HERMiT Q".
  190.  
  191.      If, for some reason, HERMiT does not get off with this triplet of KEYS,
  192. you might still be able to "KILL" it by just pressing: "HERMiT Q".  In this
  193. case HERMiT sends an input event message to the entire input device to make
  194. sure that the keys are going to be "listened" to by the running copy of 
  195. itself.
  196.  
  197.      Now, remember that it is still possible to have HERMiT blocked from
  198. operation because another running program MAY BE USING SOME OF THE ABOVE KEY
  199. COMBINATIONS.  So, if you get stuck trying to save a picture with HERMiT,
  200. have this fact in mind.  You might be able to still save a picture though.
  201.  
  202.      HERMiT WILL SAVE THE SCREEN AFTER 20 SECONDS WITHOUT PRESSING ANY KEYS!
  203.  
  204.      If you want to save the screen of a program 20 seconds after you run 
  205. HERMiT, just run HERMiT as follows: HERMiT 20.
  206.  
  207.      The program will notify you that it is waiting for about 20 seconds 
  208. before it saves the front screen.  This will give you plenty of time to get to
  209. the desired screen.  After it saves the screen, HERMiT will be operating as
  210. usual.  If you specify any number of seconds other than 20, the program
  211. will default to 20 seconds.
  212.  
  213.      One of the main reasons for not being able to save certain screens, is
  214. that the programs creating those screens block your keyboard and prohibit
  215. you from interfering with their respective tasks.  This can be done in 
  216. the C language by using instructions like "Disable(); Forbid();".  HERMiT
  217. will not be able to help in such cases.  Actually, no known program will.
  218.      The HERMiT icon opens a small "CON:" window on your screen to accept the
  219. output.  If you really want to see that output, just extend that window as
  220. much as you please.  You can do that by changing the dimensions of that
  221. window.  Just "Info" the icon and make the change.
  222.      I have tried to cover a lot of cases of possible ... misuse of the
  223. program.  However, if you come across any situations at all where HERMiT
  224. does not work properly, please let me know.  I would appreciate it.
  225.  
  226.      I would like to express my thanks to Robert Miles (Excalibur BBS,
  227. Dallas) for sharing his knowledge with me on the hunks of executable files.
  228.  
  229.      Have fun!!!
  230.  
  231.                  @@-->>> HERMES
  232.  
  233.      This program has been released under the SHAREWARE concept.  If you
  234. find it useful, please send $15.00 to the following address.  You can use
  235. the same address for SUPPORT on other programs by hERMES.
  236.  
  237.      A. G. Kartsatos      (...Author Of IconLab 1.3 And LoGG 1.0)
  238.      8524 Caladesi Island Drive
  239.      Temple Terrace, FL 33637-7310, USA
  240.  
  241. DISTRIBUTION:
  242. =============
  243.  
  244.      Feel free to distribute this version of HERMiT, WITH THIS DOC INTACT,
  245. to any bulletin boards and non-profit establishments in the US and
  246. abroad.
  247.      You are also allowed to upload this version to major electronic boards
  248. like BIX, Compuserve, Delphi, GEnie, PLink, etc.
  249.      The inclusion of HERMiT, or any part of it, in any form in a commercial
  250. package, or its use for any commercial purposes, is illegal without the ex-
  251. plicit permission of the author.
  252.      Most nationally and internationally sold disks with Amiga software are
  253. considered commercial packages by this author.  Only The Amiga User Group
  254. "Disk Of The Month" disks are excluded.
  255.  
  256. DISCLAIMER:
  257. ===========
  258.  
  259.      The usual disclaimers concerning computer software apply to this
  260. product.
  261.      Although this program has been tested extensively for its accuracy and
  262. reliability, the author will accept no liability whatsoever for damage
  263. resulting from the use, misuse, or excessive use of it.
  264.